Inside Macintosh: QuickDraw GX Printing /

Chapter 4 - Advanced Printing Features / Advanced Printing Features Reference

Functions / Color Profile Functions

GXSetFormatProfile

You can use the GXSetFormatProfile function to change the current color profile for a format object.

OSErr GXSetFormatProfile (gxFormat theFormat,
            gxColorProfile oldProfile, gxColorProfile newProfile);

theFormat

A reference to the format object.

oldProfile

A reference to the profile that has been associated with the format object.

newProfile

A reference to the profile to add to the list of profiles for a format object.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

You can call the GXSetFormatProfile function to change the current profile for a format object, to replace an existing profile that is associated with the format object, or to remove a profile from the list of color profiles that are associated with the format object.

A printer driver or printing extension defines the values of the oldProfile and newProfile parameters that determine what happens in response to this message. Table 4-7 shows an example.

The actions of the GXSetFormatProfile function

Value of oldProfile	Value of newProfile	Action taken
nil	nil	None
Valid	nil	oldProfile is deleted from the list of profiles associated with the format object.
nil	Valid	newProfile is added to the list of profiles for the format object and becomes the current profile.
Valid	Valid	oldProfile is deleted from the list of profiles, newProfile is added, and newProfile becomes the current profile for the format object.

RESULT CODES

gxSegmentLoadFailedErr

A required code segment could not be found, or there was not enough memory to load it.

SEE ALSO

The gxSetFormatProfile message is described in Inside Macintosh: QuickDraw GX Printing Extensions and Drivers.

Color matching, color profiles, and color profile resources are described in Inside Macintosh: Advanced Color Imaging.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help